Single-value picker is quick tool to develop a dialog box for collecting single value from user input. A single-value picker can be used in base forms and grid views.

The best practice is to invoke single-value picker dialog boxes from buttons or menu items' scripts (apply to base forms and grid views). See the following JavaScript piece for example; here param and defaultValue are optional arguments. param is only applicable for lookup and select types; Using defaultValue will override the single-value picker's Default Value.

function MyButtonClicked([parm, defaultValue])
{
   var userInput = OpenSingleValuePicker('my-ref-key'[,parm,defaultValue]);
   if(userInput)
   {
      // value1 is available for all types of single-value pickers;
      // value2 is only available for daterange type as End Date.
      alert(userInput.value1);
      alert(userInput.value2); 
   }
}

Single-value pickers can be also used in grid views to bulk update selected row records. When creating a grid view menu, select the following Command Script:

doBulkUpdate('{gridId}', ?[, ?]);

Replace the first question mark with the single-value picker's reference key, and optionally replace the second optional question mark with param value as discussed in the above case.

• Name / Title: Picker name and the dialogbox title;
• Reference Key: Unique reference key;
• Field Title: Display text in the front of the web field;
• Field Type: UI type of the input web field;
• Description: Picker description and the dialogbox message;
• Default Value: Default value; it may be overridden by HTTP query;

• Lookup: Lookup picker's reference key;

• Number Type: Integer number or float number;
• Accuracy: Only applicable to float type number;

• Database: Integer number or float number;
• Select SQL: Only applicable to float type number; precision digits.